Skip to content

Add background_import param to import_records()#310

Open
njvack wants to merge 1 commit intoredcap-tools:masterfrom
uwmadison-chm:master
Open

Add background_import param to import_records()#310
njvack wants to merge 1 commit intoredcap-tools:masterfrom
uwmadison-chm:master

Conversation

@njvack
Copy link
Contributor

@njvack njvack commented Dec 12, 2025

Setting this to True will ask REDCap to import records in the background; this will work similarly to the background import in the Data Import Tool.

Because this flag is not supported in old REDCap versions, if you do not specify it, it will not be added to your request parameters at all and you will get the default REDCap behavior.

Currently, REDCap defaults to foreground imports.

The response from a background import will look like: {'success': True}. There is no explicit way to monitor a background import; the best idea I have so far is to include a sentinel value at the end of your records and poll for that value.

Closes #307

Setting this to True will ask REDCap to import records in the
background; this will work similarly to the background import in the
Data Import Tool.

Because this flag is not supported in old REDCap versions, if you do
not specify it, it will not be added to your request parameters at all
and you will get the default REDCap behavior.

Currently, REDCap defaults to foreground imports.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add backgroundProcess support for import_records?

1 participant